Running your dynamic browse window
Now you can run your window. Because the window is a dynamic object, defined only by records in the Progress Dynamics Repository, there is nothing to compile. However, you cannot simply run a dynamic window as a procedure. There is a tool that lets you run it as a logical container. This is referred to as launching the container.
|
To launch your window: |
- Select Compile
Dynamic Launcher from the AppBuilder main window. - Type oeCustBrowseWin in the Name of Container to Launch field, as shown:
- The Run Persistent toggle box tells the launcher to run the dynamic window as a persistent procedure. This is usually the case for Progress Dynamics objects.
- The Always run new instance toggle box tells the launcher to create a new instance of the container each time you choose Run. If you want to only have a single instance of any container running at once, unselect this toggle box.
- The Clear repository cache toggle box refreshes all object definition data cached on the client, enabling you to see the effects of your latest work. Leave this toggle box selected when launching a dynamic object that you just created or modified.
- The Clear data cache toggle box refreshes the application data cache. This cache contains data from your application database, rather than from the Repository.
- The Destroy ADM Super Procedures toggle box clears another level of the framework’s persistent data. Choosing this option shuts down all currently running super procedures, forcing them to be restarted using the latest versions of the files.
- The Clear the MRU history button
clears the Dynamic Launcher’s list of most recently used files. - Choose Run. The Container Browser window appears:
- Try out a few of the features that all browser windows built with this template inherit automatically. For instance, when you resize it, the toolbars and the browser resize appropriately.
- Choose the Filter Records button
and a dynamic filter dialog box for this table’s query appears. Index information is generated automatically to let the user know which fields to use for efficient filtering. Enter a value in the From and To columns to filter all records where the field matches that range of values. - Choose OK on the Filter dialog box to return to the Customer Browse window. Note that the Filter Records button now has a check mark
on it. This shows that your data has been filtered. - You can also choose the Find button
to reposition to the first record matching the criteria you enter. - Exit the Customer Browse window and the Dynamic Launcher.
The Dynamic Launcher has the following options:
Entering a value in just the From column filters all values greater than or equal to that value. Scroll the browser to the right, or resize it, and you can see that fields with a word index can be filtered by contained words, and all character fields can be filtered on a character string match, as shown:
If you select the Permanent radio button, the filters you have set up are saved as a permanent user preference in the Repository. Otherwise, the filters last for the current session. This is an example of customizations and preferences saved for each different user. (Because the framework tools themselves are largely implemented in the framework, this is equally true for developers and for end users.)
The framework knows the effective and ineffective ways to filter the data based on the available indexes. If you choose an ineffective filter criteria, you might see the following message:
The other standard buttons transfer values from the browse to an Excel™ spreadsheet or XML document, generate Audit trail records if auditing is enabled for the table, and associate Comments or a Status record with a selected record.